home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Collections: Memphis Amiga Group
/
MAG Communications Programs (1988-08)(Memphis Amiga Group)[Disk 102].zip
/
MAG Communications Programs (1988-08)(Memphis Amiga Group)[Disk 102].adf
/
DU3+HR
/
duIII2.doc
< prev
next >
Wrap
Text File
|
1988-07-30
|
63KB
|
1,173 lines
DirUtil III Plus HR
File Management Utility for the Commodore Amiga
Copyright 1987, 1988 Nathan Barber
Release Date July 30, 1988
DirUtil III Plus HR is Copyright 1987,1988 by Nathan Barber and is NOT
in the Public Domain. However, the author hereby releases the included
demo version of the program and this documentation for distribution
under the conditions described in the following paragraphs:
This program is distributed as a demo ONLY. If you use and like the
demo of this program and wish to receive the fully operational version,
send a minimum of $25 in United States currency to the following
address:
Nathan Barber
227 Chateaugay St. NW
Fort Walton Beach FL 32548
For further information regarding enhancements or other questions, you
may also contact me on GEnie as NBARBER and with FIDOnet mail addressed
to Nathan Barber sent to 366/3.
With the first $25 of your payment, you will receive the latest version
of the program and a personal demo version that you may freely dis-
tribute in order to collect commission bonuses (see below). Amiga User
Groups are invited to inquire about bulk distribution of the program at
reduced rates. Any funds remaining after the initial fee will be put
towards the purchase of enhanced versions of the program as they become
available at the rate of $10.00 each. I will supply the blank disk as
a bonus for advance payment of at least one updated version at the time
of initial purchase.
If you wish to have a change made to the program, enclose its de-
scription with your payment and I will try to add it to your copy prior
to shipping. Bugs (none currently known) reported prior to the release
of an enhanced version will be fixed for registered owners of DirUtil
III Plus HR for the cost of shipping and materials. Normal enhancement
updates are available for $10.00 and a blank, formatted disk sent to
the address above ($11.50 with no disk).
DirUtil III Plus HR will perform very closely to what is described in
this documentation. However, because of the nature of the program, the
author cannot assume responsibility for any lost time and/or profits or
claims of fitness for a particular purpose resulting from the use of
the program.
Commission Sales:
----------------
The following policy supercedes all other commission offers previously
extended to Amiga User Groups and individuals.
After registering your copy of the program, the disk you receive will
contain a personal demo version of the program with your serial number
prepended with the letter "D". The disk will also contain a file in
the popular ARChive format that you may upload to any BBS or tele-
communications service in the country that is not specifically excluded
by the listing that follows this paragraph. You may also distribute
your personal demo copy through any other channel except as noted in
the following paragraph. Commissions are paid as credits towards
future updates unless otherwise requested. An update credit of $5.00
will be awarded for each copy of DirUtil III Plus HR that is registered
using the serial number contained in your personal demo. It is VERY
important that you make sure that persons registering a copy dis-
tributed by you include their serial numbers as no credit can be given
without this number. Cash credits will be given ONLY if requested in
writing at 50% of the current credit balance in your account. Program
updates will be mailed automatically when your account reaches $10 of
credit if an enhanced version of the program is available. Persons
wishing cash payment should address a letter to me informing me of
their desires. Cash payments will be sent out every three months
(approximately) or when the cash balance reaches $50.
Restrictions on Distribution:
----------------------------
DirUtil III Plus HR, its documentation, support programs, and all asso-
ciated works MAY NOT be distributed through the following entities
without prior written permission of the author. Furthermore, all
previous versions of this program written by Nathan Barber and col-
lectively known as DirUtil III and DirUtil III Plus must be removed and
destroyed if any part of this package, or any collection of files
containing this package is available from the same source as this
package.
DirUtil III Plus HR (demo version) must not be distributed to:
1. Any person in the employ of Random Access Computers in Fort Walton
Beach Florida, nor to the business itself.
2. Any person in the employ of Oscar's Computers in Okaloosa County,
Florida, nor to the business itself.
3. Any officer of the Okaloosa Amiga Research Society (OARS) in Fort
Walton Beach, Florida.
4. Any other business, organization, or computer Bulletin Board
Service in Florida having one of the following area code and
prefix combinations:
904-862 904-863 904-837 904-243 904-244 904-581
904-664 904-651 904-678 904-897 904-729 904-939
904-267
5. The General Electric Network for Information Exchange (GENIE)
EXCEPT for releases uploaded by NBARBER.
These restrictions are to allow a limited beta test area free from
prior versions. Item 5 is included as this is the national network that
will have the most current version and will be handled by myself and no
one else.
System Requirements:
-------------------
DirUtil III Plus HR requires any Amiga with 512K of memory, one disk
drive, and Kickstart 1.2 or higher. Two disk drives are highly
recommended and certain commands may require more than 512K of memory
ie. SHOWING large picture files.
Introduction:
------------
DirUtil III Plus HR has been around in one incarnation or another for
over a year (since March 1987). For a year, DirUtil III Plus HR has
been "marketed" as a pay before you play product with various demo
versions of the program being distributed. I must say that I am quite
pleased with all the people who supported the previous versions of the
product and were willing to bear with me as I made improvements that
delayed shipment of a fully operational copy. I previously placed a
$20 charge on the program. I am now releasing an updated two window
version of the program which included many user suggested enhancements
in the hope that it will make the Amiga a better place to live and
play. I plan on releasing a new version with user suggested improve-
ments approximately every two months or when I have received ten user
requested improvements.
Features of DirUtil III Plus HR:
-------------------------------
DirUtil III Plus HR was made to be a replacement for the AmigaDOS Work-
Bench and CLI interfaces and an alternative to the other file manage-
ment systems now on the market. DirUtil III Plus HR encompasses the
best features of both Workbench and CLI and consumes little memory or
disk space. DirUtil III Plus HR also provides many features not
available or tedious to perform in the normal AmigaDOS environment.
DirUtil III Plus HR contains over 100 functions with variations
including user definable gadgets.
DirUtil III Plus HR is not limited to the preset devices that some
programmer thought up. The program automatically reads YOUR devices
upon startup.
With DirUtil III Plus HR, you can delete 90% of the commands in your C:
and SYS:system/ directories, thereby freeing valuable space on your
disks.
Unlike other file management programs, DirUtil III Plus HR contains all
the code you need to do normal disk functions such as COPY, DELETE,
DISKCOPY (with multiple copy ability), FORMAT and SHOW. Other lesser
programs make you reinsert the Workbench disk to load the command.
DirUtil III Plus HR is the ONLY program that will show full overscan
pictures successfully and allow scrolling of those pictures.
DirUtil III Plus HR is a viable hard disk backup program when the
program's powerful file selection and archiving features are used.
Known Problems beyond the control of DirUtil III Plus HR:
--------------------------------------------------------
Some older device drivers such as VDK:, do not support setting a
filedate after a file is created. This causes DirUtil III Plus HR to
sometimes fail to set the datestamp on a file it has just copied. If
this happens, just select the file with the bad date (hitting the DATE
gadget will show you the files to select), then hit the RIGHT button on
FIXOBJ.
The Amiga Workbench has a very poor and inconsistent interface to
AmigaDOS. It does not honor the DOS path command in a predictable way
and does not support the setting of a current directory without the use
of the DOS CD command. Consequently, the DOS batch file commands
listed under the description of the RUN command are practically useless
if DirUtil III Plus HR is invoked from WorkBench. If you have only one
drive and are trying to run DirUtil III Plus HR strictly from Work-
Bench, be prepared for a lot of disk swapping when using the RUN and
EXEC commands.
Occasionally, the SHIFT and ALT keys will appear to have become stuck
in the wrong position. This is caused by hitting the SHIFT or ALT keys
when the DirUtil III Plus HR main window is active, then releasing them
when it's windows are not active. Hitting and then releasing the SHIFT
or ALT key after activating one of the DirUtil III Plus HR windows will
eliminate the problem should this occur. Also, it has come to my
attention that the TimeSaver Clock/Macro add-on from C-Ltd uses the
right SHIFT key for it own purposes. If you have this product, you
must use the LEFT SHIFT key on those commands that specify the use of
EITHER SHIFT key.
Certain IFF pictures, most notably gray scale, hi-res pictures produced
by DigiView V2.0, save incorrect color cycling information. DirUtil
III Plus HR compensates for this but certain combinations might slip
through as new IFF picture formats are introduced. Also, the new,
large scrollable pictures produced with Express Paint from PAR Software
have been reported to cause a crash when viewed from DirUtil III Plus
HR. As I do not have this software, proper handling of these pictures
might be a long time in coming. The maximum size picture thus far
shown successfully shown is 768x480.
IMPORTANT TRACKING INFORMATION:
------------------------------
The copy of DirUtil III Plus HR you received contains a serial number.
You can view the serial number and version number by hitting the ALT-
SHIFT-CONTROL key combination at the same time. This serial number is
used to track distribution of the program and to provide me with the
internal version number of the program for update purposes. When you
register your copy of DirUtil III Plus HR, include the serial number
and version number of the copy you are registering. This will enable
me to pay commissions as outlined above.
Instructions:
Workbench Startup: Click on the DirUtil III Plus HR icon. The
program will load and open a small window on the Workbench screen
as well as its own screen. DirUtil III Plus HR will then load
the filelists from the default device if it is known, otherwise
it will default to the RAM: device.
CLI Startup: Type "du" or "run du" (no quotes) to start the
program. A stack of 25000 is recommended if running the program
on a hard disk or on a floppy disk with a large number of files.
DirUtil III Plus HR will then load the filelists from the default
device if it is known, otherwise it will default to the RAM:
device.
NOTE: The small window that opens on the Workbench screen while
DirUtil III Plus HR is running may not close when the program is
exited. If this happens, it means that another program has
"adopted" that window as its own. The window will close when all
programs using it have closed.
THE DISPLAY WINDOWS: DirUtil III Plus HR opens its own 640x400
interlaced Intuition screen during operation. If you do not like
interlace mode, or need to save memory, hitting SHIFT-ESC will
toggle DirUtil III Plus HR into a non-interlaced mode. The title
bar of the largest window on this screen has a display of
"F: xxxxxxx C: xxxxxxxx". The number after the "F:" is the
amount of FAST ram you have available in your Amiga. The number
after the "C:" is the amount of CHIP ram you have available in
your Amiga. The CHIP ram number is the most important as the
Amiga does not perform well when CHIP ram is extremely low (below
32000 bytes). Just above the Intuition window front/back gadgets
on the upper right is a one pixel tall screen front to back
gadget for moving the DirUtil III Plus HR screen. The majority of
the rest of this window contains the filenames and subdirectories
associated with the "S"ource and "D"estination directories. You
may manually change the "S" and "D" directories by entering a new
name in the string gadgets just above this file display. Above
the "S" and "D" gadgets are two lines used for status infor-
mation. The two slider gadgets running down the middle of the
screen are used to position the file display window. The second
window, labeled "Function Window", contains all the gadgets that
control what functions will be done to the highlighted files.
This window may be dragged or moved to the back to of the large
window to allow more filenames to be displayed.
To select/deselect a directory entry, click on its name in the
file window with the left mouse button. Click on one of the
gadgets to take the selected action on the selected names.
To enter a subdirectory, click on its name with the RIGHT mouse
button. NOTE: in order for any function using the RIGHT mouse
button to function, one of the two DirUtil III Plus HR windows
must be active. To automate this requirement, I highly recommend
either DMouse or MachMouse (both available on many BBS' around
the country).
If you invoke a function that you really did not mean to invoke,
click anywhere in the DirUtil III Plus HR screen with the LEFT
mouse button to abort the operation. You will be asked if you
really want to abort the next time DirUtil III Plus HR checks the
status of the mouse. The mouse is checked before any operation
that would write to a disk and periodically while DirUtil III
Plus HR is passively acting on a disk. Any operation can be
aborted, even reading the directory of a disk.
If you hit and drag either of the slider gadgets, the filenames
will scroll in real time with the movement of the gadget.
The two file windows are treated on an equal basis. Either may
be the "S"ource or "D"estination directory. To switch between
them, just click on the half of the screen containing the window.
You will see the highlighting change and the letters "S" and "D"
change places.
The string gadgets at the top of the DirUtil III Plus HR window
are:
S: The source directory.
D: The destination directory.
Device Gadgets:
The first two rows of four gadgets each are reserved for the
first eight file system devices that you have in your system.
These gadgets will always include the disk device from which
the program was booted. DirUtil III Plus HR automatically
fills these in alphabetical order when the program is first
booted. If you have less than eight devices, the remainder
of these gadgets will remain blank and not used. If you have
more than eight devices, any unused user gadgets will be
filled with the overflow. If DirUtil III Plus HR must use
this "overflow" area, the gadget text will be prefixed with
the '@' symbol to signify a temporary allocation. Such
temporary device gadgets will not be saved upon exiting the
program. DirUtil III Plus HR can update this listing at any
time with a command from you (see USER GADGET descriptions).
Hitting the left button on one of these gadgets sets the
"S"ource directory to the root of the selected device and
reads the filelist of that device if possible. Hitting the
right button on these gadgets sets the "D"estination gadget
to the root of the selected device and reads its filelist.
While reading the filelist of a disk, DirUtil III Plus HR
might bring up the prompt "Directory Loop - Continue?". This
means that the current filelist has over 256 entries in it
and DirUtil III Plus HR is warning you that your disk
directory might be damaged in such a way as to eventually
hang the machine if processing is continued. If you are not
sure of the contents of the directory you are reading, it is
good procedure to click "ABORT" and see what DirUtil III Plus
HR has read so far. There are many valid situations in which
a directory can have more than 256 proper entries. If you
know this to be the case, feel free to click "CONTINUE" and
proceed. If you click "CONTINUE" and the directory really is
in a loop, you will have to click the left mouse button to
abort the filelist scan operation. Since DirUtil III Plus HR
is only limited by available memory as to the number of file-
names it can process, you run the risk of running out of
memory if a directory loop is allowed to continue forever.
REMINDER: One of the two windows on the DirUtil III Plus HR
screen must be active in order for any function that involves
the right button to work properly.
ALL(D)
Select all files in the current "S" directory, including the
ones "scrolled off" the window. Hitting the RIGHT mouse
button will highlight all subdirectories as well. Hitting
the right mouse button while holding a SHIFT key will
highlight all files whose protection flag includes the
archive flag.
CLEAR
De-select all selected files in the "S" directory. Hitting
the right button will clear all selected subdirectories.
COPY
Copy selected files to the directory specified in the "D"
gadget. "D" must contain an existing directory path and CAN
go across devices. COPY preserves the protection status,
file comment, and creation date of the original file when
making the copy. DirUtil III Plus HR will clear the archive
bit on any copied file as per AmigaDOS convention. If you
select to copy a subdirectory, DirUtil III Plus HR will
create that directory on the "D" disk and copy all the files
to the new directory. If an error condition is encountered
while copying files inside the subdirectory or anywhere else
in its particular "tree", all files associated with the
subdirectory will be deleted from the destination disk.
Hitting the right mouse button on COPY copies all selected
files as above and sets the archive bit for the original
file. Non disk devices such as PRT:, SER:, and PAR: may have
files copied to them by manually entering the name of the
device into the "D" gadget.
DELETE
Delete selected files and directories. You will be prompted
for confirmation before any files are deleted.
RENAME
Renames selected files to a different name or path (on the
same device). You must enter the COMPLETE PATH and NAME of
the renamed file. You will be prompted for the new name of
the file for every highlighted file.
MAKEDIR
This will create a new subdirectory. You will be prompted
for the name of the new subdirectory. Enter the FULL PATH of
the directory you wish to create. DirUtil III Plus HR will
prompt you with the current "S" directory as a starting point
to try and save you some typing. Hitting the right button
will create a directory AND create a drawer icon to go with
it. Also, using the right button option will allow you to
create a drawer icon for an existing directory.
PARENT
Go to the parent directory of the "S" gadget. Clicking on
the gadget with the right mouse button will go to the parent
directory of the "D" gadget.
TYPE
Use this to view standard ASCII files on your screen. Use
the slider gadget to move anywhere in the text instantly.
Hitting the LEFT mouse button moves back a page. Hitting the
RIGHT mouse button moves forward a page. Cursor LEFT and
RIGHT emulate the LEFT and RIGHT mouse buttons. Cursor UP
and DOWN pages four lines at a time either up or down.
Hitting "T" will go to the top of a file and "B" key goes to
the bottom of a file. Hit the CLOSE WINDOW gadget or the ESC
key when you are through looking at the file. Hitting the
right mouse button on the gadget will type a file to the
screen in HEX and ASCII 20 numbers at a time. The mouse
pages the file as above and the cursor left, cursor right and
ESC keys also function as above. If you have trouble reading
the text displayed in the interlace mode, try dropping into
non-interlace mode before hitting TYPE.
INFO
Used to show the number of free bytes from the device
associated with the "S" gadget. Hitting the right button on
this gadget will display the same data for the "D" gadget.
The numbers given in parentheses are the number of disk
sectors used and free respectively and can generally be
compared to the corresponding numbers given by the BYTE
command. INFO also supports Workbench 1.3 with the Fast
Filing System. Comparing the numbers INFO gives for FFS and
non-FFS devices is not very useful due to varying data block
sizes.
PRINT
Copies the chosen files to PRT: using the current Preferences
settings.
SWAP
Flips the highlighted status of all files in the "S" di-
rectory, including subdirectories. Hitting the RIGHT button
will copy DirUtil III Plus HR's file information from the "S"
file window to the "D" file window WITHOUT actually copying
any files. This effectively gives you two windows that
contain the same information without having to re-read the
disk's directory over again.
BYTE
Adds up the number of bytes of the selected files, sub-
directories and any files in the subdirectories and displays
the sum, the number of files, and the number of subdi-
rectories. The number in parentheses is the number of disk
sectors used by the files and subdirectories and can gen-
erally be compared to the corresponding numbers given by the
INFO command.
RUN
"RUNS" the selected files from inside DirUtil III Plus HR.
The file C:RUN must be available for RUN to function proper-
ly. If you only have one disk drive or you do not want to be
bothered with having to reinsert the system disk to load the
AmigaDOS "run" command, add the following lines to your
startup-sequence and only run DirUtil III Plus HR from the
CLI:
copy c:run ram:
copy c:cd ram:
path add sys:c
assign c: ram:
This batch file will, however, fail to find the normal DOS
commands if the system disk is not in the drive when the command
is invoked. Hitting this gadget with the right button will EXEC
a batch file. The files "NEWCLI" and "ENDCLI" must be available
in your search path for EXEC to function. If the batch file
aborts, you will have to type "ENDCLI" to close the DOS window.
As a useful side effect to this abnormally ended batch file, if
you need a quick NEWCLI, just EXEC a file that is NOT a batch
file. EXEC will abort, but you will have a newcli and you will
not have to waste a user gadget on the command!
EDITOR
Call the program named "ED" in order to edit the selected files.
The editor is a completely separate task and runs independently
of DirUtil III Plus HR once started. Hitting the right button
will call "ED" and put quotes around the filename to be edited.
Many editors cannot parse quotes; this alternate format is a last
resort when trying to edit files which contain spaces in their
filenames. Since the editor runs as a separate task, the file
length of the edited file may not match the number displayed by
DirUtil III Plus HR. All commands will adopt the new file size
if the edited file is accessed again.
LIST
LIST will print the names, sizes, dates of creation and pro-
tection status of ALL files in the filelist. You will be
prompted for an output filename. If the output file already
exists, LIST will append its data to the end of the existing
file.
DATE
DATE is a toggle. If highlighted, the date of creation and
protection status of the files in the filelist will be displayed
instead of their size. Hitting the right button on DATE will
check all the files in the "S" directory against all files in the
"D" directory and highlight all those that are newer than a file
of the same name found in the "D" directory.
PROTECT
PROTECT summons a requester containing ten gadgets. Eight of
these gadgets are the alphabetic flags associated with the
protection status of a selected file. Click on these gadgets
until you have the pattern you wish to use for all the high-
lighted files. Hitting OK will protect the file according to
your pattern. Hitting ABORT leaves the pattern as it was before
the requester was entered.
MOVE
MOVE performs a COPY and DELETE on the selected file(s) from the
"S" directory to the "D" directory. MOVE will move whole sub-
directories to any other path including another subdirectory or
another device. MOVE is the recommended way to get a file from
one place to another quickly since it will do a RENAME command if
the files are destined to be on the same device rather than copy
then delete a file. Successful MOVES between different devices
will result in the original file being deleted.
BEWARE: there is a bug in the DOS 1.2 RAM: device. You should
not MOVE a file to RAM: if it already exists.
SEARCH
Search a file for a pattern. You will be prompted for the search
string. Upper/lowercase characters are different ONLY if you
select this function with the right mouse button. If the "\"
character is found in the search string, the next two characters
are converted into a single hexadecimal digit and used as one
character in the overall search. If a question mark is found in
the pattern, it will match any character found in that position.
The search pattern is limited to 60 characters. SEARCH will
abort if you hit the close window gadget on its output window
while the search is in progress. When searching a file using a
hexadecimal pattern, it is recommended that you only use the
right button option to prevent unwanted upper/lowercase
conversions.
DISKCOPY
COPY a whole disk without regard to file structure. You can copy
with one drive or two and can copy using the 5.25" Transformer
drive. DISKCOPY will prompt for a source and destination drive.
In the case of one drive copies, you will be prompted when disk
swaps are needed. Click the DirUtil III Plus HR window's close
window gadget in the upper left corner of the screen when you
have swapped disks. DISKCOPY works ONLY with the floppy drives
listed in the prompt requester. DISKCOPY assumes you are copying
disks with the same number of cylinders ie. 3.5" to 3.5" or 5.25"
to 5.25", but not 3.5" to 5.25". Hitting the right button on
this gadget will perform a DISKCOPY and verify the written data
more stringently. DISKCOPY does not require that the destination
disk be pre-formatted, it will do that itself if needed.
DISKCOPY uses all available RAM starting with FAST RAM and
continuing with CHIP RAM if needed. If you have enough free RAM
to load the entire contents of the disk into memory at one time,
DirUtil III Plus HR will ask you if you wish to make another copy
of the disk after the first copy is complete. If you tell
DirUtil III Plus HR you would like another copy, it will prompt
you to insert another blank disk (formatted or unformatted) into
the drive that was specified as the destination and click the
close gadget on the larger of the two DirUtil III Plus HR
windows. You may make as many copies of the same disk as you
would like, just hit "ABORT" when you wish to stop making copies.
ARCV
List the contents of an ARC file to the screen. Hitting the right
button on this gadget will list the contents of a ZOO file (up to
V1.31 of ZOO) on the screen. DirUtil III Plus HR will print the
names of V1.40 (or higher) ZOO files, but not the full pathnames
allowed in V1.40. This will be included in future versions of
DirUtil III Plus HR. Hit the Window Close gadget to exit from
the listing window.
FIXOBJ
FIXOBJ will "pad" a file you have downloaded to enable the Amiga
scatter loader to process it correctly. FIXOBJ has two modes of
operation. First, if the file is NOT already padded and is an
executable, FIXOBJ pads it so that upon uploading, anyone
downloading that file need not FIXOBJ it again, just load and
run. Second, FIXOBJ will pad a file that has been downloaded but
not yet fixed. FIXOBJ will not pad any file that is not a stand
alone executable ie. ARC files. Hitting the right button on this
gadget will change the dates of the highlighted files to the
current date. This is to fix a bug in some device handlers and
will not be needed using floppies, RAM: or hard disks with
properly written drivers.
SAVE OLD
SAVE OLD is a toggle. If enabled, you cannot copy/move/rename a
file to a file that already exists in the new directory path with
the same name. Hitting the right button will highlight all the
files that exist on both the "S" and "D" devices.
FREEZE
FREEZE is a toggle. If FREEZE mode is active, any name you
highlight will not be de-selected upon completion of subsequent
functions that act upon highlighted files.
SHOW
SHOW the selected files as IFF pictures. If you have selected a
subdirectory, DirUtil III Plus HR will also show any pictures
contained within these subdirectories. Click in the upper left
hand corner of the screen or hit the ESC key to cease viewing a
picture. If the selected pictures have color cycling information
imbedded in them in Dpaint format, the picture will cycle
automatically. This automatic cycling may be manually overridden
by hitting the right button on SHOW. DirUtil III Plus HR will
reject any file that is not a picture. It will also attempt to
show a picture recorded in "overscan" mode. Overscan mode is
very desirable in professional video, but many monitors cannot
display the full picture at one time. If this is the case on
your monitor, use the left, right, up, and down cursor keys to
move the picture around on the monitor. I have purposely left
out bounds checking for this scrolling picture feature to enable
the largest possible pictures to be shown. If you scroll the
picture too far in a given direction, the Amiga will show it in a
manner not conducive to pleasant display. No harm will result,
but the picture will not look like a picture! To correct a
situation such as this, just scroll in the opposite direction and
the strange display mode will correct itself.
SLIDE
SLIDE is a toggle. The slideshow mode will show all selected
pictures with a blank backdrop screen. You do not have to click
in the upper left hand corner to view the next picture. When
starting the slide show, you will be prompted for the delay
factor between pictures. There are 50 time units per second ie.
entering 50 (the default) will pause one second between pictures.
The normal abort procedure for DirUtil III Plus HR functions
still holds: just click the backdrop screen to the back and
click inside DirUtil III Plus HR' window as usual. Clicking the
right mouse button on SLIDE will toggle a continuous SHOW mode
that will show the selected files and directories until DirUtil
III Plus HR is manually aborted.
CHANGE
Perform a DISKCHANGE command on a floppy drive. You will be
prompted for the drive name.
FORMAT
FORMAT a floppy drive. You will be prompted for both the drive
name to format and the new name for the disk. Disknames must be
less than 32 characters in length. Format destroys all previous
data on a disk so be careful when using it. Format works on 3.5"
drives and the 5.25" Transformer drive. Hitting the right button
will format the disk and do a more complete verification of the
disk at the same time. Either method of formatting a disk is
faster than the standard AmigaDOS format command.
RELABEL
Change the name of the disk represented in the "S" gadget. You
will be prompted for the new diskname. Names must be less than
32 characters in length.
COMMENT
Set the comment field of the selected files. You will be
prompted for the new comment to attach to each selected file in
succession. You must use the AmigaDOS LIST command or the
WorkBench INFO command to see the comment from outside DirUtil
III Plus HR. DirUtil III Plus HR's COPY command will replicate
the comment on any file you copy unlike normal AmigaDOS (upto
V1.2) and is the preferred way to preserve comments on a file.
Hitting the right button on COMMENT will show the comments
attached to the highlighted files.
CRYPT
CRYPT is a toggle. If lit, any file you TYPE, COPY, MOVE or SHOW
will be crypted/de-crypted according to the current password key.
To enter this password key, hit the right mouse button on CRYPT.
The decryption password must be at least 5 characters long. If
the CRYPT gadget is lit, this password will be used for various
commands listed below. DirUtil III Plus HR encodes 33.5 kilo-
bytes of data per second so using this function will not slow
down operation significantly. The encryption mode is reversible;
ie. copying a file twice with data encryption turned on will
result in an unchanged copy of the original file. No encryption
algorithm is foolproof, but the one used in DirUtil III Plus HR
is as good as you will see outside the government. Without the
password, no one (even the author) will have any kind of rea-
sonable change of gaining access to the file's data.
ARC
Click on the files to be contained in the ARC file, but remember,
a command line can only be 255 characters total. You will be
prompted for the name of the ARC file to create. You must enter
the WHOLE path and name of the ARC file to create WITHOUT THE
.ARC EXTENSION. The ARC command will be loaded from your current
path if DirUtil III Plus HR was run from the CLI or from your C:
directory if run from the Workbench. See the endnotes to help in
ARCing files with one disk drive. Hitting the right button on
ARC will UNARC the selected ARC files. You will be prompted for
the device and/or subdirectory into which the UNARCed files are
to be placed. The default is the "D" directory. If you change
this default, it must be changed to a device or subdirectory that
already exists. UNARC will overwrite any file by the same name
that previously existed in the output directory. Both ARC and
UNARC open a console window on the screen to display their
progress. ARC and UNARC require that the file C:RUN be present
on your disk. You may follow the instructions listed under the
RUN command to change this requirement.
ZOO
Uses the exact same syntax as the ARC gadget. Hitting the right
button on the gadget will UNZOO a file following the same
sequence as described in the UNARC command above. DirUtil III
Plus HR requires Amiga ZOO V1.40 or above to function properly.
Unlike Amiga ARC, ZOO will allow the archiving and unarchiving of
subdirectories. DirUtil III Plus HR will not list these cor-
rectly (yet), but will extract them properly. ZOO and UNZOO
require that the file C:RUN be present on your disk. You may
follow the instructions listed under the RUN command to change
this requirement.
USER GADGETS
These are completely user definable gadgets which perform various
functions depending on the definition string for a particular
gadget. To set a command string for any of these gadgets under
normal circumstances, hit the right button on the gadget and
enter a string the format NNNNNNNNMCCCCCCCCCCCCCCCCCC where "N"
represents the name to be displayed in place of the default USER
definition, "M" is a modifier or a normal letter (see below), and
"C" is the command string attached to this USER gadget. A
complete definition should be no more than 255 characters. If
the definition you are changing is already occupied by a special
device name (discussed below), you must hold either ALT key
before hitting the right mouse button. A successful operation
will replace the old definition with the new one. The next time
you hit the LEFT button over the same gadget, the command string
will be interpreted depending on the modifier used. If the "M"
character is not a "\" or "|", the command string will be parsed
(based on the commands below) and the result sent to AmigaDOS for
execution. If the modifier is a "\", the command string is
parsed and sent to AmigaDOS without the need to click on a
filename. This form is used for invoking frequently used
external commands that may require parameters, but not filenames.
If the modifier is a "|", the string of characters following the
"|", but not including it, are taken to be the new setting of the
"S" gadget and the appropriate directory will be read. Any USER
gadget containing the "|" modifier will behave just like its
counterpart on the top two rows of gadgets ie. hitting the right
button on it will set the "D" gadget to the drive/path associated
with it. This explains the need for using the ALT key to set or
reset these definitions. For full compatibility with all DOS and
NON-DOS commands, DirUtil III Plus HR uses the AmigaDOS RUN
command when executing any USER gadget with the exception of the
special "|" modifier above. The file called "du2.config"
included with this package is a working example of a conf-
iguration.
The parser looks for a % character followed by one of the
following characters:
"S" refers to the current "S" directory.
"D" refers to the current "D" directory.
"F" refers to the full path and filename of a high-
lighted file.
"N" refers to the filename of a highlighted file
excluding the path name.
"E" refers to a parameter that you will be prompted
for during the execution of the user definition
(entered only once at the beginning of a multi-
file operation unless %R is encountered).
"C" refers to the hexadecimal address of DirUtil III
Plus HR' screen for use in the CONMAN program.
"B" this character does not generate any text, but
tells DirUtil III Plus to move its screen to the
back when the command is executed.
"R" resets the flag and allows a user to subsequently
enter new text at a %E prompt. This allows for
multiple user inputs in the same user definition.
"P" Sets the prompt string for use by the %E command.
%P should occur before the %E command it is to
affect. The string should end with a | character
and be no more than 30 characters long.
"%" Use a real percent sign instead of interpreting it
as a command introduction. IE if you want a % in
your user text, type %% instead.
"I" If interlace mode is not already active, turn it
on.
"L" If interlace mode is already active, turn it off.
"Z" Stands for ZAP devices. It will clear all device
definitions from the first eight device gadgets as
well as any overflow that has been stored in the
user definable area. It will then scan the list
of current file system devices and fill in the
appropriate gadget boxes with your current device
list. DirUtil III Plus HR will handle a removed
device (as of Workbench 1.3).
EXAMPLE:
-------
The "S" directory is "df0:s" and your have clicked on the
file "startup-sequence". The "D" directory is "df1:backups".
The definition string for one of the user gadgets looks like:
"MAKEBAK copy %f to %d/%n.bak"
The quotes in the above definition ARE NOT TO BE TYPED, they
are for delineation only. DirUtil III Plus HR will interpret
this string and send the following string to AmigaDOS:
"copy df0:s/startup-sequence to df1:backups/startup-
sequence.bak"
Notice the "/" character in the definition, this is required
to make a valid path name. The carriage return between
startup- and sequence is caused by the word processor this
document is printed with and is not actually sent to
AmigaDOS. The included config file shows many of the ways to
use the parser.
EXAMPLE 2:
---------
A user gadget definition looks as follows:
" PKAX %pEnter Output Dir|run > nil: cd %e+<CR>pkax %f"
This definition will set the prompt for the %E command to
"Enter Output Dir", prompt for a string, then use the +
option of the RUN command to run two commands in sequence.
The <CR> symbol means to type a CTRL-J in its place. This is
the way AmigaDOS recognizes a carriage return in a manner
equivalent to typing it from the keyboard. The first command
will CD to the string just entered ie. the disk or sub-
directory where you wish the files to be unARCed into. After
CD runs, the file named PKAX will be run with the filename
and path currently being processed. I will leave you with
the method I use to unARC files when I am not using the built
in ARC functions of DirUtil III Plus HR. This example
requires a version of DirUtil III Plus HR dated June 2, 1988
or later to function.
" PKAX %Enter Output Dir|run > nil: cd %e+<CR>pkax
> CON:0/150/640/50/UNARCing_%n_to_%e -r %b%f"
IMPORTANT:
---------
When DirUtil III Plus HR first boots, it will look in your S:
directory for a file called "du2.config". If this file
exists, the USER gadgets will be preloaded with the file's
contents. On leaving DirUtil III Plus HR, this file will be
saved ONLY IF you have changed the definition of a gadget.
HINT:
----
You can use the AmigaDOS Execute command to run a batch file
using a user gadget. This will allow more flexibility when
creating your user definitions by allowing parameters to be
passed to the batch file for conditional testing.
IMPORTANT OPERATIONAL NOTES:
---------------------------
There are no known conditions that will crash DirUtil III Plus HR.
If you get a software failure during use, be sure that the error
is not caused by another task running at the same time. When all
else fails, AND you can replicate the error using DirUtil III Plus
HR AND provide an exact command sequence that produces the error,
let me know and I will fix the bug. I have gone to great lengths
to provide low memory and stack error checking, however if you get
sporadic guru meditations during heavy usage of DirUtil III Plus
HR, or you have a hard drive with a lot of subdirectories, you may
need to increase your stack size. This can be done from the CLI
or using the Info command on the Workbench.
DirUtil III Plus HR' "S" directory will default to RAM: if the
default directory cannot be determined. If the RAM disk handler
cannot be loaded, DirUtil III Plus HR will exit cleanly.
DirUtil III Plus HR has a limit of 255 characters for directory
path names. This is based on the length of a command line in the
AmigaDOS CLI environment.
AmigaDOS, and consequently DirUtil III Plus HR, has problems with
spaces in file and volume names. This problem will result in un-
expected results when using some external commands from within
DirUtil III Plus HR. DirUtil III Plus HR tries to minimize this
problem by putting quotes around commands with spaces in them, but
not all programs can parse quotes in the way AmigaDOS handles
them. Also, DirUtil III Plus HR uses the volume name of a disk
rather than its device specification for most operations.
Consequently, disks with the same volume name mounted at the same
time tend to produce unpredictable results.
The DISKCOPY command of DirUtil III Plus HR assumes it is copying
a normal AmigaDOS disk. However, DirUtil III Plus HR will copy
any non-copy protected disk non-AmigaDOS disk. If a non-AmigaDOS
disk is detected, DirUtil III Plus HR will not update the creation
date on the destination disk, thus making an exact copy of the
original.
DirUtil III Plus HR was developed and tested on an Amiga 1000 with
2 3.5" drives, 1 5.25" Transformer drive, 1 5.25" 880K Quad
Density drive (emulating a 3.5" drive), 2.5 Megabytes of RAM and 2
50 meg C-Ltd SCSI hard drives. DirUtil III Plus HR has also been
tested on the Amiga 500 with and without the A501 RAM Expander,
and on an Amiga 2000 with and without RAM expansion and hard disk.
This implies that some users may find it difficult to use DirUtil
III Plus HR on a machine with only one drive. DirUtil III Plus HR
has been tested under these conditions and performs quite well
although disk swapping will cause irritation when using external
commands. It is also not recommended that you invoke ARC, UNARC,
ZOO, or UNZOO with only one drive (don't forget the RAM: drive
however). Also, in order to provide the best possible throughput,
DirUtil III Plus HR buffers a whole picture in ram while it is
being decoded for showing. This buffering may cause problems when
showing some pictures on a 512K machine if memory has become
fragmented.
Quick Reference Chart for DirUtil III Plus HR
GADGET LEFT BUTTON RIGHT BUTTON R/SHIFTED
------------------------------------------------------------
EIGHT "S" = DRIVE "D" = DRIVE
DEVICE IN GADGET IN GADGET
GADGETS
ALL(D) ALL FILES ALL FILES/SUBDIRS ALL ARCHIVE
INFO "S" INFO "D" INFO
PARENT "S" PARENT "D" PARENT
PROT PROTECT FILES
CLEAR CLEAR FILES CLEAR SUBDIRS
SWAP SWAP "S" & "D" COPY "S" TO "D"
TYPE TYPE ASCII TYPE HEX/ASCII
RUN DOS RUN DOS BATCH FILE
COPY COPY SELECTED ARCHIVE COPY
MOVE MOVE SELECTED
PRINT PRINT SELECTED
DELETE DELETE SELECTED
FORMAT FORMAT FLOPPY FORMAT W/VERIFY
MAKEDIR CREATE SUBDIR
RENAME RENAME FILES
DISKCOPY COPY WHOLE DISK DISKCOPY W/VERIFY
LIST LIST FILES
SEARCH STRING W/UL CASE SEARCH U <> L CASE
EDITOR EDIT WITH ED EDIT + QUOTES
BYTE SIZE OF FILES COMPARE FILE SIZES
FIXOBJ PAD FILES FIX FILE DATE
CHANGE DISKCHANGE
ARCV LIST ARC LIST ZOO
RELABEL CHANGE "S" NAME CHANGE "D" NAME
DATE+ SHOW DATES COMPARE DATES
FREEZE+ FILE SELECTION
SAVE OLD+ KEEP SAME NAMES CHECK EXISTENCE
SLIDE+ SSHOW ON/OFF SHOW CONTINIOUS
COMMENT SET FILE COMMENT PRINT FILE COMMENT
SHOW SHOW W/CYCLE SHOW W/O CYCLE
CRYPT+ ENCRYPTION SET ENCRYPT KEY
ZOO MAKE ZOO FILE UNZOO FILE
ARC MAKE ARC FILES UNARC FILE
USER** INVOKE USER SET USER
** ALT KEY REQUIRED TO SET SOME FUNCTIONS
+ FUNCTIONS AS TOGGLE
VERSION NUMBER IS SHOWN BY CTRL-ALT-SHIFT
INTERLACE TOGGLED VIA SHIFT-ESC
Documentation for DirUtil III Plus HR Palette Program
The program named PAL on the DirUtil III Plus HR disk is used to
change the colors of the file window and type window. The program
can only be run when DirUtil III Plus HR is already running.
Also, PAL will only search out the front most DirUtil III Plus HR
screen in case you have multiple copies of the program running.
You have two options upon loading PAL: MAIN and TEXT. Click on
MAIN to alter the colors of the file window and click on TEXT to
change the colors for the TYPE, HTYPE, SEARCH, ARCV, and ZOOL
commands. Upon exiting the program, a file called "du2.color"
will be written to the S: directory for future use. DirUtil III
Plus HR is still running when the palette program is active and
you can switch between all the various displays until you have the
colors set just right. You cannot exit DirUtil III Plus HR, nor
change its resolution, until the palette program has terminated.
Update list for May 12, 1988 release (internal)
1. Fixed bug that would sometimes cause crash when run from Work-
bench.
2. Eliminated all constraints on number of filenames and number of
lines of text when reading directories and displaying text files
respectively. IF DIRUTIL III PLUS HR PROMPTS YOU THAT THE
DIRECTORY IS IN A LOOP, IT IS UP TO YOU TO DECIDE WHETHER TO
CONTINUE READING FILENAMES.
3. ARCV and ZOOL now use a custom window on the DirUtil III Plus
HR screen.
4. Added new option (%C) for the user gadgets.
------------------------------------
Update list for June 2, 1988 release (internal)
1. Added two new options for the user gadgets (%P and %R).
2. Added limited support for showing overscanned pictures, NOT
PERFECTED.
------------------------------------
Update list for June 14, 1988 release (internal)
1. Added two new options for the user gadgets (%I and %L).
2. Added switchable screen interlace mode to save memory. See docs
for command key.
3. DISKCOPY now uses FAST RAM as a buffer if present.
4. DISKCOPY now prompts for a source disk instead of assuming "S".
5. DISKCOPY w/ right mouse button changed, see docs.
------------------------------------
Update List for July 7, 1988 (internal)
1. More error checking for DISKCOPY (disk in drive and write
protect status now checked)
2. Support for file copying to non disk devices added, see docs.
------------------------------------
Update List for July 12, 1988 (internal)
1. ESC key now exits the SHOW command. In addition, the cursor
keys will scroll the picture. SEE DOCS FOR LIMITS.
2. Fixed bug in SHOW command that kept 768x480 pictures from
showing. INFORMATION: ShowPrint II and uShow have the same bug!
3. DirUtil now makes no assumptions about font size to allow
running from a truly stock Workbench disk set to use Topaz 9 font.
4. RENAME now renames multiple files in one pass.
5. RELABEL can relabel "D".
6. COMMENT now allows different comments to be put on files when
more than one file is selected at a time.
------------------------------------
Update List for July 14, 1988 (internal)
1. Completely keyboard free operation available when using string
gadget. If you want the default, hit CONTINUE. Hit ABORT to stop
the function.
2. FORMAT now checks for the presence of a disk before proceeding
and will not try to format a write protected disk.
3. Directories now updated properly after a RENAME or MAKEDIR to a
volume not listed.
4. Major overhaul of previously ignored error conditions. None are
fatal, but they are annoying since they cause the in memory repre-
sentation of a file to not match its physical counterpart on disk.
No error is printed, but the file will not unhighlight after being
processed.
5. MAKEDIR (with icon option on) will now create a drawer icon
even if the directory already existed. (Allows easy addition of
icons to already existing directories)
6. Default text for unused user gadgets is now a blank space
rather than the former "USER1", "USER2" setup to reduce clutter on
the screen.
7. Added more error messages to DISKCOPY and FORMAT.
8. Fixed a memory allocation bug in FORMAT.
------------------------------------
Update List for July 18, 1988 (internal)
1. Aborting a function when DirUtil III Plus HR is processing a
subdirectory is now much cleaner.
2. Cleaned up overscan handling code to use a "best guess" on very
large pictures.
3. Fixed a problem with SHOWing Deluxe Photo Lab (c) pictures
caused by larger than standard color map setup use by this
program. INFORMATION: ShowPrint II and uShow have the same bug!
4. MOVE not unhighlighting a file fixed.
5. Stack requirements reduced in SHOW and SLIDESHOW modes.
6. Sped up SHOW by 8 cycles per scan line. (big deal, no bug)
7. Fixed SHOWCONT (broken since May 12, 1988)
8. Being unable to open the default device now causes a clean exit
rather than a lockup.
9. Added output directory prompt to UNARC and UNZOO.
------------------------------------
Update List for July 19, 1988 (internal)
1. Device gadgets now updated after every file operation to
reflect possible changes by outside programs, makes %Z user
definition obsolete in most cases.
------------------------------------
Update List for July 21, 1988 (internal)
1. Added multiple DISKCOPY capability.
2. Added case insensitive search (now default).
------------------------------------
Update List for July 22, 1988 (general release)
1. Code cleanup and optimization, docs updated, released to
public.
------------------------------------
Update List for July 30, 1988 (general release)
1. Several small bugs fixed following initial release.
------------------------------------